fix(security): server-side API key management and SSRF hardening#33
Open
SweetSophia wants to merge 13 commits intoMiniMax-AI:mainfrom
Open
fix(security): server-side API key management and SSRF hardening#33SweetSophia wants to merge 13 commits intoMiniMax-AI:mainfrom
SweetSophia wants to merge 13 commits intoMiniMax-AI:mainfrom
Conversation
* refactor: extract ChatPanel into focused modules Decompose the 1472-line ChatPanel god component into four focused files: - toolDefinitions.ts (133 lines): tool defs, system prompt builder, config guard - ChatSubComponents.tsx (178 lines): CharacterAvatar, StageIndicator, ActionsTaken - SettingsModal.tsx (270 lines): LLM + image generation configuration UI - useConversationEngine.ts (341 lines): conversation loop + tool dispatch hook ChatPanel/index.tsx reduced from 1472 → 632 lines (-57%), now a thin shell that wires state to UI. No behavior changes — pure structural refactor. Benefits: - Conversation engine is testable in isolation - Settings modal can be reasoned about independently - Each file has a single clear responsibility - Future PRs can target specific modules without touching the whole * fix: consolidate duplicate ModManager imports in useConversationEngine.ts Agent-Logs-Url: https://github.com/SweetSophia/OpenRoom/sessions/f4ebc43a-24c2-4853-b135-f234fd25d12b Co-authored-by: SweetSophia <[email protected]> * fix: stabilize runConversation identity to prevent listener churn runConversation was recreated on every render, causing the onUserAction subscription effect to unsubscribe/resubscribe on each render. App actions emitted during the cleanup-rebind window could be silently dropped. Since runConversation only reads from refs (no reactive state), wrapping it in useCallback with an empty dependency array makes its identity stable across renders, eliminating the churn. * fix: address code review findings across ChatPanel modules useConversationEngine: - Wrap callbacks in ref to prevent stale closure in stabilized runConversation - Break outer loop after respond_to_user to avoid extra model round-trip - Add console.warn for unparseable tool call arguments - Handle loadMemories rejection with fallback to empty array ChatSubComponents: - Reactivate existing inactive layer instead of skipping it - Use ref for cleanup timeout to prevent stale timeout interference index.tsx: - Move setSessionPath call from render body to useEffect - Reduce reload effect deps to sessionPath only, add cancellation guard SettingsModal: - Sync local state from parent props via useEffect toolDefinitions: - Replace hardcoded emotion examples with generic reference to character keys * fix: address review feedback on types, timeout cleanup, and config guard Agent-Logs-Url: https://github.com/SweetSophia/OpenRoom/sessions/6cd6bd9b-6a80-474a-b067-8f2ff9f8f32a Co-authored-by: SweetSophia <[email protected]> * fix: address Copilot review — tool loop, save snapshot, layer cleanup useConversationEngine: - Remove inner break on respond_to_user so sibling tool calls (e.g. finish_target) still execute before outer loop stops index.tsx: - Guard loadMemories .then/.catch with cancelled flag - Snapshot session/data at debounce schedule time instead of reading refs at fire-time, preventing cross-session data mixing - Remove now-unused sessionPathRef2 ChatSubComponents: - On layer reactivation, cancel pending cleanup timeout and explicitly deactivate all other layers to prevent dual-active state * fix: Prettier import style, stale memory guard, remove redundant ref useConversationEngine: - Break React import to multiline per Prettier config - Guard loadMemories handlers against session change during async gap index.tsx: - Remove unused sessionPathRef_forSet ref — setSessionPath in useEffect alone is sufficient for module-level sync * fix: flush debounced save on cleanup, remove stale dep in handleResetSession index.tsx: - Flush pending saveChatHistory in cleanup instead of discarding, preventing data loss on rapid session switches - Remove modCollection from handleResetSession dependency array (uses refs and functional state updates, no direct read needed) * fix(ChatPanel): useLayoutEffect for setSessionPath; fix debounced save write amplification Agent-Logs-Url: https://github.com/SweetSophia/OpenRoom/sessions/4ddaf906-91f2-4ac3-ac97-7ce3fd331545 Co-authored-by: SweetSophia <[email protected]> * refactor: extract PendingSaveSnapshot type from inline ref type Agent-Logs-Url: https://github.com/SweetSophia/OpenRoom/sessions/4ddaf906-91f2-4ac3-ac97-7ce3fd331545 Co-authored-by: SweetSophia <[email protected]> * fix: ModManager value import, sessionPath out of save deps, redact sensitive args from warn log Agent-Logs-Url: https://github.com/SweetSophia/OpenRoom/sessions/1954e0a2-8dec-4da9-85f4-92df5e2ddf00 Co-authored-by: SweetSophia <[email protected]> * fix: only break loop when respond_to_user is sole tool call Previously the loop broke after respond_to_user even when other tools ran in the same batch. If the model planned to emit follow-up tool calls (e.g. finish_target) in a subsequent round-trip, those were silently skipped. Now the loop only terminates when respond_to_user was the only tool call — batched tool calls get their follow-up round-trip as intended. --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]>
…state 1. Error Boundaries: Wrap AppWindow and ChatPanel in ErrorBoundary components so crashes don't take down the entire Shell. 2. Path Traversal: Replace regex-based sanitization in session-data and session-reset endpoints with resolve()-based validation that ensures paths stay within SESSIONS_DIR. 3. SSRF/Header Injection: LLM proxy now uses an explicit allowlist for forwarded headers. x-custom- headers are validated to prevent auth injection. Target URLs are validated for protocol. 4. AbortController: Conversation loop accepts AbortSignal. handleSend and processActionQueue cancel previous conversations before starting new ones. 5. Stale State: handleSend reads chatHistory from chatHistoryRef instead of closure, fixing race condition.
API keys are no longer stored in or sent from the browser: - LLM proxy now reads keys from ~/.openroom/config.json and injects them server-side based on detected provider - Browser clients (llmClient, imageGenClient) no longer send Authorization or x-api-key headers - localStorage is no longer used as a config cache - Provider auto-detection from target URL with manual override via X-LLM-Provider header This eliminates XSS-based API key theft as an attack vector.
- Replace warn-only SSRF check with strict provider host allowlist - Only known API hosts allowed (openai, anthropic, deepseek, etc.) - Local LLM hosts only with ALLOW_LOCAL_LLM=true env var - Validate target host BEFORE injecting server-side API keys - Add isAllowedTarget() with test coverage
…ffect clobbering - index.tsx onSave: fall back to submitted values on reload failure, only close modal when reload succeeds - SettingsModal: always include customHeaders (send empty string to clear), add hasLocalEditsRef to prevent useEffect from clobbering in-progress edits - vite.config.ts: inferProvider wraps URL parse in try/catch for malformed input - viteConfig.test.ts: consistent env restore pattern, add malformed URL test for inferProvider - e2e/app.spec.ts: stub /api/llm-config for deterministic unconfigured state in settings test
- import useRef in SettingsModal and mark API key edits as local edits - avoid storing update objects/raw keys in ChatPanel state on reload failure - return structured save results from config persistence and llmClient - return 500 for server-side /api/llm-config write failures - fix E2E config stub to return valid empty JSON - update tests for structured save results
- mark provider/model UI interactions as local edits in SettingsModal - clear preserved API keys when provider/base URL changes without a new key - require HTTPS for public provider proxy targets - add upstream proxy timeout handling - expand vite config helper coverage for null/URL/env edge cases
Covers empty string, missing key, and whitespace-only apiKey — all should produce hasApiKey=false.
There was a problem hiding this comment.
Pull request overview
This PR moves LLM/image-gen API key handling out of the browser and into a server-side Vite middleware, and hardens the LLM proxy against SSRF by enforcing a strict host allowlist and scrubbing sensitive headers. It also refactors ChatPanel into smaller units (engine/tool defs/settings modal) and updates docs/formatting across multiple app guides.
Changes:
- Store secrets only in
~/.openroom/config.jsonand return redacted config to the client (hasApiKeyflags), with server-side key injection in the proxy. - Add SSRF protections (target URL parsing + host allowlist + HTTPS enforcement) and stricter header forwarding + upstream timeout.
- Refactor ChatPanel into extracted modules and add tests for Vite proxy/config helpers.
Reviewed changes
Copilot reviewed 39 out of 39 changed files in this pull request and generated 9 comments.
Show a summary per file
| File | Description |
|---|---|
| e2e/app.spec.ts | Updates E2E behavior when config is missing to open Settings instead of sending. |
| apps/webuiapps/vite.config.ts | Adds server-side config persistence/redaction, SSRF allowlist checks, header scrubbing, proxy timeout, and path traversal sanitization. |
| apps/webuiapps/src/pages/Twitter/twitter_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Twitter/twitter_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/MusicApp/meta/meta_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/MusicApp/meta/meta_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Gomoku/meta/meta_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Gomoku/meta/meta_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/FreeCell/freecell_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/FreeCell/freecell_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/EvidenceVault/evidencevault_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/EvidenceVault/evidencevault_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Email/email_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Email/email_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Diary/diary_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Diary/diary_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/CyberNews/meta/meta_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/CyberNews/meta/meta_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Chess/chess_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Chess/chess_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Album/album_en/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/pages/Album/album_cn/guide.md | Formatting-only guide adjustments. |
| apps/webuiapps/src/lib/llmModels.ts | Adds hasApiKey and LLMConfigUpdate to support redacted configs + partial updates. |
| apps/webuiapps/src/lib/llmClient.ts | Removes localStorage caching; routes requests through proxy with scope headers and server-side key injection. |
| apps/webuiapps/src/lib/imageGenTools.ts | Uses hasUsableImageGenConfig to handle redacted configs. |
| apps/webuiapps/src/lib/imageGenClient.ts | Removes localStorage caching; adds hasApiKey + update types + proxy scope header for image generation. |
| apps/webuiapps/src/lib/configPersistence.ts | Implements update-based saving with structured {ok,error} results and legacy migration handling. |
| apps/webuiapps/src/lib/tests/viteConfig.test.ts | Adds unit tests for Vite config helper functions (redaction, allowlist, parsing). |
| apps/webuiapps/src/lib/tests/llmClient.test.ts | Updates tests to reflect server-side key injection and save-result surfacing. |
| apps/webuiapps/src/lib/tests/imageGenClient.test.ts | Updates tests for redacted config loading, usability checks, and proxy header behavior. |
| apps/webuiapps/src/lib/tests/configPersistence.test.ts | Updates tests for redacted config behavior and save error propagation. |
| apps/webuiapps/src/components/Shell/index.tsx | Wraps AppWindow + ChatPanel in an ErrorBoundary to isolate crashes. |
| apps/webuiapps/src/components/ErrorBoundary.tsx | Adds ErrorBoundary component with retryable fallback UI. |
| apps/webuiapps/src/components/ErrorBoundary.module.scss | Styles for the ErrorBoundary fallback UI. |
| apps/webuiapps/src/components/ChatPanel/useConversationEngine.ts | Extracts the conversation/tool-call loop into a hook. |
| apps/webuiapps/src/components/ChatPanel/toolDefinitions.ts | Extracts tool definitions and system prompt builder. |
| apps/webuiapps/src/components/ChatPanel/SettingsModal.tsx | New settings UI supporting placeholder keys + partial updates + save feedback. |
| apps/webuiapps/src/components/ChatPanel/index.tsx | Refactors ChatPanel to use extracted modules and server-side config model. |
| apps/webuiapps/src/components/ChatPanel/ChatSubComponents.tsx | Extracts ChatPanel helper UI components and message rendering. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
apps/webuiapps/src/components/ChatPanel/useConversationEngine.ts
Outdated
Show resolved
Hide resolved
3 tasks
PR MiniMax-AI#33 and MiniMax-AI#34 review feedback: Security: - Config file now written with mode 0600, directory with mode 0700 - Block hop-by-hop headers (RFC 9110) in proxy passthrough - Validate header values are strings, not arrays, before use - Fix misleading comment about symlink resolution in sanitizeRelativePath - Redact sensitive data from file tool call summaries in chat history UX / Correctness: - Thread AbortSignal through chat() to fetch() for real request cancellation - SettingsModal trims all inputs on save to prevent whitespace issues - onSave returns proper error feedback when config reload fails - hasUsableLLMConfig normalizes config in-place (trimmed baseUrl/model) - Whitespace-only image gen API key no longer treated as enabled Accessibility: - ErrorBoundary: add role=alert, aria-live=assertive, type=button Race conditions: - handleMediaReady ignores stale loads when user switches emotions quickly Tests: 118 passing
- Chess: add WebGL capability detection before Canvas mount; show diagnostic fallback panel when WebGL context creation fails instead of crashing silently into ErrorBoundary - Engine tests: add useConversationEngine test suite (4 cases) covering AbortSignal threading, file-tool summary redaction, whitespace-only image-gen key handling, and mid-loop abort behavior - Bugfix: include 'file_path' in tool summary extraction keys so file_write summaries show 'file_write(file_path: ...)' instead of bare tool name
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Move API key storage from client-side
localStorageto server-side config with proxy-based enforcement and redaction. Harden the LLM proxy against SSRF attacks.Changes
Checklist
pnpm run lintpassespnpm buildpasses